home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d21 / qostnote.arc / APISTART.TEC < prev    next >
Text File  |  1990-07-05  |  3KB  |  78 lines
  1. ID:AP Starting DESQview Under API
  2. DESQview API Technical Note
  3. by Stan Young
  4.  
  5.           Starting DESQview Under API Program Control
  6.  
  7. Many API programs are designed to run in much the same as any 
  8. off-the-shelf program in the DESQview environment.  That is, the 
  9. user simply selects the program from the Open Window menu, it 
  10. opens and once running can begin to control and take advantage of 
  11. DESQview.
  12.  
  13. Creating an "auto-start" macro for DESQview can allow the program 
  14. to be brought up automatically on the start of DESQview.  The 
  15. "auto-start" macro is described in the DESQview users manual 
  16. (page 89 in the Version 2 manual).  The auto-start macro can be 
  17. used to start either API or standard applications automatically 
  18. when starting DESQview.
  19.  
  20. An auto-start macro is generally a good starting method where 
  21. you want to make sure your API program is run, but want to make 
  22. most of the features of DESQview available to your users.  The 
  23. default for starting using this method is that all of the 
  24. standard menu items of DESQview are enabled.  Your API program 
  25. has to specifically disable them after starting up if you 
  26. do not want all of the menu selections available.
  27.  
  28. However, sometimes API developers will want their programs to 
  29. control the system more fully.  To accomplish this, you can start 
  30. DESQview as follows:
  31.  
  32. DV {program information filename}
  33.  
  34. An example of a program started in this fashion is on every users 
  35. DESQview disk in the SETUP.BAT file.  It reads as follows:
  36.  
  37. DV SETUP.DVP {additional parameters}
  38.  
  39. The additional parameters listed in SETUP.BAT are specific to 
  40. DESQview operation, and would not normally become a part of your 
  41. API program startup (/OK assumes "non-enhanced keyboard", /NS 
  42. means don't read the setup file, use defaults).
  43.  
  44. Run the DESQview Setup and you will get an idea of the defaults 
  45. under which API programs started from the command line are run:
  46.  
  47.      1.  After display of the DESQview copyright screen, the 
  48.      application listed in the DVP file is automatically run.
  49.  
  50.      2.  All access to the DESQview menu is disabled.  DESQview 
  51.      macros, including the auto-start macro for the window are 
  52.      enabled if present, but access to the Learn menu is not 
  53.      available.
  54.  
  55.      3.  Terminating the application terminates DESQview and 
  56.      drops you out to the DOS prompt.
  57.  
  58. Obviously, the DESQview Setup program is a limited, 
  59. single-tasking environment, but it demonstrates that an API 
  60. program program started from the command line is firmly in 
  61. control.  Once started, the API program can start additional 
  62. tasks (NEW or NEWPROC in assembler, app_new or app_start in C or 
  63. Pascal), and selectively enable the features of DESQview (Manager 
  64. streams 00 to 3F in Assembler, or win_allow function in C or 
  65. Pascal).  
  66.  
  67. The only feature which cannot be enabled is the Open Window item. 
  68. When an API program is started from the command line, the 
  69. DESQVIEW.DVO file, which contains the Open Window menu 
  70. information, is not read into memory and the Open Window option 
  71. will not be available.  Your API program could of course produce 
  72. its own "front end" menu of programs to open if you like.  If you 
  73. want to allow users to have access to the Open Window menu, you 
  74. would want to start up using the auto-start macro.
  75.  
  76.         Copyright (C) 1990 by Quarterdeck Office Systems
  77.              * * *   E N D   O F   F I L E    * * * 
  78.